home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d3 / jedit.arc / JEDIT.DOC < prev    next >
Text File  |  1986-09-15  |  21KB  |  595 lines
  1. @
  2.  
  3.  
  4.                                           
  5.                                           
  6.                                           
  7.                                           
  8.                                           
  9.                                           
  10.                                           
  11.                                           
  12.                                           
  13.                                         EJEditF
  14.                                           
  15.                                  EThe ultimate editorF
  16.                                           
  17.                                     Eversion 1.00F
  18.                                           
  19.                                           
  20.                                           
  21.                                   Eby John BernsteinF
  22.                                           
  23.                                    ECopyright 1986F
  24.                                           
  25.           
  26.                                           
  27.                                           
  28.                                           
  29.                                           
  30.                                           
  31.                                           
  32.                                           
  33.                                           
  34.                     Jedit is  a Shareware  product.  We encourage
  35.                     you to  copy and  share this  program and its
  36.                     documentation, unmodified  with others.    If
  37.                     you find  that you  use the  program,  please
  38.                     support the  Shareware marketing  concept  by
  39.                     registering with us. Thank you
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.           
  71.           
  72.           EIntroductionF
  73.           
  74.           Ever tried to edit BAT files with EDLIN?  Ever used a program
  75.           requiring data input but didn't have editing capabilities?  Ever
  76.           do any programming?  If you answered yes to any of these
  77.           questions, you will love JEdit.  JEdit is a full screen editor
  78.           for use with any Ascii text file.  JEdit allows you to edit files
  79.           as big as your memory (minus about 60k for JEdits use), you can
  80.           have lines as long as you want (no more 254 column limit).  JEdit
  81.           includes all the most commonly used editing features found in
  82.           editors costing hundreds more, such as block movement and
  83.           deleting, windowing, and a slew of other features.
  84.           
  85.           
  86.           EHow to get started--Setting up JEditF
  87.           
  88.           Generally, JEdit will be located in it's own directory, but this
  89.           isn't necessary.  When you pick a home for JEdit, make sure that
  90.           these two files are in the directory:
  91.           
  92.                EJEDIT.COMF      the program
  93.                EEDITERR.MSG    Fthe error message file
  94.           
  95.           It is possible to use JEdit without the error message file, but
  96.           if JEdit runs into any problems, you won't be able to figure out
  97.           what exactly that problem is.
  98.           
  99.           Once JEdit is in its new home, all that is left to do is to run
  100.           JEdit.  You can start JEdit two ways:
  101.           
  102.                EJEDIT <filename>F
  103.                EJEDITF
  104.           
  105.           The first example tells JEdit to load itself and also load the
  106.           file <filename> and get it ready to be edited.  The second
  107.           example just loads JEdit and gets ready to edit a new file.
  108.           
  109.           
  110.           EThe JEdit screenF
  111.           
  112.           When JEdit is finished loading, the JEdit screen will be
  113.           displayed.  This is where you will do your editing.  The top line
  114.           displays the name of the file you are currently editing and also
  115.           what will happen when you press the Esc key.  The bottom of the
  116.           screen contains some more useful information.  On the left side
  117.           is the indicator box.  This will tell you if you are in insert
  118.           mode (indicated by Ins), if you are in word wrap mode (indicated
  119.           by Wrap) or if you are in smart tab mode (indicated by Tab).
  120.           
  121.           In the middle of the bottom line is the cursor position
  122.           indicator.  These numbers tell you exactly where the cursor is
  123.           located within the file.  These can be used for lining up tables,
  124.           figuring out centering....or you could just ignore them!
  125.           
  126.           
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.           EEditing with JEdit--Cursor MovementF
  137.           
  138.           Cursor movement in JEdit is just like in any other program.  The
  139.           arrow keys move in the appropriate direction.  PgUp and PgDn move
  140.           a page up or down in the file.  Home and End move the cursor to
  141.           the beginning and end of the current line.  If you hold down the
  142.           Ctrl key while pressing the forward or backward arrow key, the
  143.           cursor skips a word at a time in the appropriate direction.  Ctrl
  144.           plus the PgUp or PgDn jumps to the beginning or the end of the
  145.           current file.
  146.           
  147.           
  148.           EEditing with JEdit--Block CommandsF
  149.           
  150.           JEdit allows you to perform functions on large areas of text
  151.           called blocks.  When a block of text is selected it can be
  152.           deleted, moved, or copied.  To select a block, move the cursor
  153.           onto the line where you want the block to start and press F3.
  154.           Next move the cursor to the last line of the block you want to
  155.           mark and press F4.  The block is now highlighted telling you that
  156.           you can now perform any of the block commands.  Pressing Shift-F2
  157.           deletes the highlighted block.
  158.           
  159.                EWARNING:F  as of this time there is now way to recover a
  160.                deleted block.
  161.           
  162.           If you want to make a duplicate (a copy) of the block in another
  163.           place, simply move the cursor to where you want the block and
  164.           then press F5.  The block is now copied to the new location, but
  165.           also leaving the original block where it was.  Instead of making
  166.           a second copy of a block of text, you can move the text to a new
  167.           location.  A move is a copy and a delete in one.  First JEdit
  168.           copies your block to the new location and then deletes it from
  169.           its original location.  This is handy for re-organizing programs.
  170.           
  171.           After working with a block, you should turn it off (un-highlight
  172.           it).  To do this press Shift F5.  Now when you press any of the
  173.           block function keys nothing will happen.  You can turn the block
  174.           on again by pressing Shift F5.
  175.           
  176.           
  177.           EExiting and SavingF
  178.           
  179.           When you are finished editing a file, it is usually a good idea
  180.           to say that file.  This is accomplished by pressing Ctrl S.
  181.           JEdit now prompts you for the name of the file to save to.  If
  182.           you started JEdit with a file name on the command line, this file
  183.           name is given to you as a default.  If you wish to save your file
  184.           to this file name, just press return.  If you want to change the
  185.           file name, use the arrow keys to backup and re-type any file/path
  186.           information.  If a file already exists with the name you are
  187.           saving to, JEdit makes a copy of that file, but changes the
  188.           extension to BAK.  This prevents any accidental data loss.
  189.           
  190.           After editing a file, one usually wants to return to DOS.  Just
  191.           press the ESC key and you will be back in DOS.  If JEdit senses
  192.           that you changed something in your file and didn't save it, JEdit
  193.           will warn you and ask if you really wish to quit.  This also
  194.           prevents any accidental data loss.
  195.           
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.           
  203.           EDeleting textF
  204.           
  205.           Ever wanted to delete some text from a file?  You could always
  206.           use the block command to delete a big section.  But if you want
  207.           to "zap" only a few lines you could use the delete-a-line
  208.           command.  Just press F2 to delete a line.
  209.           
  210.                EWARNING:F  as of this time there is now way to recover a
  211.                deleted line.
  212.           
  213.           If a character is all you want to delete, the Del key will delete
  214.           the character under the cursor and then move all text to the
  215.           right of that space one notch to the left.
  216.           
  217.           
  218.           ETabsF
  219.           
  220.           JEdit treats tabs in two ways; regular tabs and smart tabs.  You
  221.           can switch between the modes by pressing Shift Tab.  In smart tab
  222.           mode (indicated by TAB in the indicator box), JEdit remembers
  223.           where you had last tabbed to and each new line automatically tabs
  224.           to that spot.  This is useful when programming in structured
  225.           languages, such as Pascal, which require a large amount of
  226.           indentation.
  227.           
  228.           In stupid tab mode (indicated by the absence of TAB in the
  229.           indicator box) no automatic tabbing is performed; each new line
  230.           it placed at the far left side.
  231.           
  232.           In either tab mode, the Tab key moves the cursor a set number of
  233.           spaces to the right.
  234.           
  235.           
  236.           ETwo more modesF
  237.           
  238.           Besides the Smart tab mode, there are two others:  word wrap and
  239.           insert mode.  With word wrap turned on, by pressing F1, every
  240.           word which goes beyond the 80th column is carried or wrapped over
  241.           to the next line.  This comes in handy when editing letters or
  242.           memos.
  243.           
  244.           Insert mode is turned on with the Ins key.  In insert mode
  245.           everything you type pushes previously type text to the right on
  246.           the line.  When not in insert mode previously written text is
  247.           just written over.
  248.           
  249.           
  250.           EIn case of emergency!F
  251.           
  252.           If JEdit ever appears to be thinking too long (which it can't do)
  253.           or takes an extra long lunch--in other words, appears to hang--
  254.           press Ctrl U until JEdit comes back to life.  Ctrl U is the
  255.           "abort and return control" command.  You can use this anywhere to
  256.           stop a function JEdit is performing.  If after repeated presses
  257.           if Ctrl U nothing happens, you're out of luck...just reboot.  On
  258.           the brighter side, I have never had JEdit lock up on me.
  259.           
  260.           
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.           ECommand summaryF
  269.           
  270.                          Command             Function
  271.                     ----------------------------------------
  272.                           F1            Toggle word wrap
  273.                           F2            Delete a line
  274.                           F3            Mark beginning of a block
  275.                           F4            Mark end of a block
  276.                           F5            Copy a block
  277.                           F6            Move a block
  278.                     
  279.                     Shift F2            Delete a block
  280.                     Shift F5            Hide a block
  281.                     
  282.                     Ctrl S              Save file to disk
  283.                     Ctrl U              Abort current function
  284.                     
  285.                     Home                Move to beginning of line
  286.                     End                 Move to end of line
  287.                     PgUp                Move up a screen page
  288.                     PgDn                Move down a screen page
  289.                     
  290.                     Ins                 Toggle insert mode
  291.                     Del                 Delete character under the cursor
  292.                     
  293.                     Ctrl  arrow key     Move forward or backwards a line
  294.                     
  295.                     Shift Tab           Toggle smart tab mode
  296.           
  297.           
  298.           ETechnical informationF
  299.           
  300.           JEdit was written using Borland International's Turbo Pascal
  301.           version 3.01a and Borland's Turbo Editor Toolbox.  JEdit was
  302.           written by John Bernstein to aid the development of other
  303.           programs (and anything else requiring editing).  JEdit consists
  304.           of over 120k of source code, all of which is Pascal and finely
  305.           tuned inline machine code.
  306.           
  307.           JEdit can edit files up to the amount of memory you have--a
  308.           maximum of 640k (JEdit cannot currently use extended memory).
  309.           
  310.           JEdit was written with the hard drive in mind.  Because of
  311.           JEdit's size, about 60k, it loads slowly from a floppy drive.  As
  312.           a result of this it is suggested that JEdit be used from a hard
  313.           drive; though this isn't necessary.
  314.           
  315.           JEdit, runs properly on both monochrome and color monitors.
  316.           Because many CGA cards create "snow" when being written to, JEdit
  317.           uses a technique to get around this.  JEdit watches for the
  318.           vertical retrace on CGA monitors and writes to them only during
  319.           this time.  This method slows down the operation of the monitor
  320.           drastically compared to the monochrome, but prevents the annoying
  321.           "snow".  When using a CGA card, it is recommended to use a PC
  322.           which operates faster than the standard 4.77 mHz PC.
  323.           
  324.           
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.           EWarranty and License agreementF
  335.           
  336.           This program and documentation are provided "as is", with out any
  337.           warranty of any kind, either expressed or implied.  If the
  338.           program should function improperly you assume the entire cost of
  339.           any and all damages caused by the program.
  340.           
  341.           Now with that out of the way...
  342.           
  343.           A license is granted to the user of this program to use copy and
  344.           distribute this program on the following conditions:
  345.           
  346.           You the user may:
  347.           
  348.                Copy and give this program, in its original form with
  349.                all documentation in original form.
  350.                
  351.                Use this program in commercial environments for commercial
  352.                purposes providing each computer running JEdit has been
  353.                registered.  Site licenses are available, ask for details.
  354.           
  355.           You the user may not:
  356.           
  357.                Sell the program and/or documentation without written
  358.                permission from John Bernstein.
  359.                
  360.                Distribute the program or documentation in any altered form,
  361.                including modifications, translations, etc..
  362.                
  363.                Modify the program in any way without written permission
  364.                from John Bernstein.
  365.                
  366.           This license is effective from the time you receive JEdit and all
  367.           related files.  The license may be broken by the user at any time
  368.           by destroying (deleting) all JEdit related files including
  369.           documentation (disk or printed).
  370.           
  371.           
  372.           EShareware SoftwareF
  373.           
  374.           JEdit is being distributed as a shareware program.  Shareware is
  375.           a method of distributing software to users.  It allows users to
  376.           try out new software without paying for it first.  If the program
  377.           is used, the user is encouraged to register with the programmer
  378.           for a small price.  Shareware is an effort to fight the high cost
  379.           of software by providing quality software at a low price.
  380.           
  381.           If you use JEdit, we ask that you register by filling out the
  382.           form on the next page.  The basic registration fee of $10
  383.           entitles you to:
  384.           
  385.                Support through GEnie
  386.                
  387.                Notification via US Mail of new versions of JEdit
  388.                
  389.                One free update upon request (we provide the disk).
  390.           
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.           If a $15 registration fee is received, you are entitled to:
  401.           
  402.                Laser printed manual
  403.                
  404.                Support through GEnie
  405.                
  406.                Notification of updates via US Mail
  407.                
  408.                Two free updates upon request (we provide the disk)
  409.                     
  410.           Additional updates will be available for free if a disk is sent
  411.           to me with a postage paid mailer.  If an update request is made
  412.           without a disk or mailer, please include $4.00 to cover the cost
  413.           of the disk, label, mailer, and shipping charges.
  414.           
  415.           
  416.           EOther products...Coming soon!F
  417.           
  418.           Very soon a custom menu system will be release called Pacific
  419.           Menu.  Pacific Menu will allow the user to set up the functions
  420.           keys to perform any DOS task.  For example, F1 could be defined
  421.           to load the mouse driver and run Microsoft Word.  When you are
  422.           finished with Word, Pacific Menu is back, ready for your next
  423.           command.  Installation is all menu driven, and only takes about
  424.           10 minutes to get going.  Pacific Menu will be marketed as
  425.           shareware, for the same low price.
  426.           
  427.           
  428.           ETrademarksF
  429.           
  430.           Turbo Pascal is a registered trademark of Borland International
  431.           Inc.
  432.           
  433.           Microsoft and Microsoft Word are registered trademarks of
  434.           Microsoft Corporation.
  435.           
  436.           GEnie is a registered trademark of General Electric.
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.           
  467.           ERegistration FormF
  468.           
  469.           Program:EJEditF
  470.           Version:E1.00F
  471.           
  472.           Name:_______________________________________________
  473.           
  474.           Company:____________________________________________
  475.           
  476.           Street:_____________________________________________
  477.           
  478.           City:________________ State:______ Zip:_____________
  479.           
  480.           Telephone:(____)-____-______
  481.           
  482.           
  483.           Product                       QTY.      Price     Total
  484.           ------------------------------------------------------------
  485.           
  486.           Basic registration            ____      $10.00    $______
  487.           
  488.           Extended registration         ____      $15.00    $______
  489.           
  490.           Additional Laser printer      ____      $ 3.50    $______
  491.           manuals
  492.           ____________________________________________________________
  493.           
  494.                                                       TOTAL $______
  495.           
  496.           Please send either a check or money order to:
  497.           
  498.                               John Bernstein
  499.                               1330 Hudson Way
  500.                               Livermore, CA 94550
  501.           
  502.           
  503.           Comments:
  504.                
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.             ECommand summaryF
  536.             
  537.                            Command             Function
  538.                       ----------------------------------------
  539.                             F1            Toggle word wrap
  540.                             F2            Delete a line
  541.                             F3            Mark beginning of a block
  542.                             F4            Mark end of a block
  543.                             F5            Copy a block
  544.                             F6            Move a block
  545.                       
  546.                       Shift F2            Delete a block
  547.                       Shift F5            Hide a block
  548.                       
  549.                       Ctrl S              Save file to disk
  550.                       Ctrl U              Abort current function
  551.                       
  552.                       Home                Move to beginning of line
  553.                       End                 Move to end of line
  554.                       PgUp                Move up a screen page
  555.                       PgDn                Move down a screen page
  556.                       
  557.                       Ins                 Toggle insert mode
  558.                       Del                 Delete character under the
  559.                       cursor
  560.                       
  561.                       Ctrl  arrow key     Move forward or backwards a
  562.                       line
  563.                       
  564.                       Shift Tab           Toggle smart tab mode
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.